package com.campus.help.mapper;

import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.campus.help.entity.Student;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;

import java.util.List;
import java.util.Map;

/**
 * 学生Mapper接口
 */
@Mapper
public interface StudentMapper extends BaseMapper<Student> {
    
    /**
     * 分页查询学生列表（带学校信息）
     */
    IPage<Student> selectStudentPageWithSchool(Page<Student> page, 
                                               @Param("studentId") String studentId,
                                               @Param("name") String name,
                                               @Param("schoolId") Long schoolId,
                                               @Param("status") String status);
    
    /**
     * 根据学号查询学生
     */
    Student selectByStudentId(@Param("studentId") String studentId);
    
    /**
     * 更新学生状态
     */
    int updateStatus(@Param("id") Long id, @Param("status") String status);

    /**
     * 获取学生统计信息
     */
    Map<String, Object> getStudentStats();

    /**
     * 批量更新学生状态
     */
    int batchUpdateStatus(@Param("ids") List<Long> ids, 
                         @Param("status") String status, 
                         @Param("updateBy") Long updateBy);

    /**
     * 根据学校ID统计学生数量
     */
    Integer countBySchoolId(@Param("schoolId") Long schoolId, 
                           @Param("status") String status);

    /**
     * 查询最近活跃的学生
     */
    List<Student> selectRecentActiveStudents(@Param("days") Integer days, 
                                           @Param("limit") Integer limit);
}